home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 013 / arc_mgr.arc / ARCF.ARC / ARCF.DOC < prev   
Encoding:
Text File  |  1987-10-08  |  4.2 KB  |  143 lines
  1. ARCF  Find Text in ARC Files.                      Version 1.0 - Oct 8, 1987
  2.  
  3.  
  4.  
  5.  
  6. Purpose:  To search files in ARC archive files for text strings.
  7.  
  8.  
  9. Format:   ARCF  [d:][path]filename[.ARC]  [filespecs...]  "text"
  10.                 [/B] [/C] [/F] [/Q] [/S] [/W]
  11.  
  12.  
  13. Usage:    The d:path\filename and "text" parameters are required.
  14.           The drive and path are optional. The 'filename' and
  15.           'filespec' parameters may contain the wildcard characters *
  16.           and ?. All files matching the 'filespec' specification
  17.           within the 'filename' are processed.
  18.  
  19.           If the 'filename' extension is omitted, the extension .ARC
  20.           is used.
  21.  
  22.           The 'text' search criteria must begin and end with a
  23. |         double quote character, e.g. ARCF TEST.ARC "SOMETHING".
  24.  
  25.           The optional switch (/x) characters must be the last
  26.           operands, e.g. ARCF TEST "april 1" /c/w.
  27.  
  28.           Normally, you would only want to search "text" files for
  29.           strings. Text files consist of ASCII record. Each record
  30.           ends in a carriage control (CR) character. The maximum
  31.           record length is 4096 bytes. To search all files, binary
  32. |         and text, use the /B option. A maximum of 80 characters
  33. |         is display when text is found in a record.  If /B is used,
  34. |         all control characters and hi-ASCII (greater than 127)
  35. |         characters are blanked out.
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.           ARCF (c) Copyright 1987 by Vernon D. Buerg. ALL RIGHTS RESERVED.
  59.  
  60.  
  61.  
  62. ARCF  Find Text in ARC Files.                      Version 1.0 - Oct 8, 1987
  63.  
  64.  
  65.                         Option Switches
  66.                         ---------------
  67.  
  68.         /B - include Binary files, i.e. files with the extensions
  69.              of .EXE, .COM, and .BIN. If omitted, only non-binary
  70.              files are searched.
  71.  
  72.         /C - case sensitive search; if omitted, the search for the
  73.              text is made regardless of the case, i.e. upper case
  74.              and lower case letters are treated the same.
  75.  
  76.         /F - display the name of the file begin searched only if
  77.              the scan text is found within the file; if omitted,
  78.              the names of all files are displayed as they are
  79.              proccesed.
  80.  
  81.         /G - supplies any encryption (garble) password, e.g.
  82.              /GPSWD would supply PSWD as the password.
  83.  
  84.         /Q - suppress beeps and bells; if omitted, beeps are sent
  85.              with error messages.
  86.  
  87.         /S - suppress displaying the names of the files being
  88. |            processed; this includes suppressing the display
  89. |            of the archive file name(s), too. When used with
  90. |            /F, the only display is of the file name that
  91. |            contains the search text.
  92.  
  93.         /W - ignore white-space; if omitted, spaces and tabs are
  94.              significant.
  95.  
  96.  
  97.  
  98.  
  99. ARCF  Find Text in ARC Files.                      Version 1.0 - Oct 8, 1987
  100.  
  101.  
  102.                         Version history
  103.                         ---------------
  104.  
  105.         1.00 - 10/8/87
  106.           - First public release.
  107.  
  108.  
  109.                         Restrictions
  110.                         ------------
  111.  
  112.         Written for the IBM PC using DOS 2.0, or later,
  113.  
  114.         ARCF is free, but it is a copyrighted work and may be distributed only
  115.         pursuant to this license.
  116.  
  117.         Permission is hereby granted to reproduce and disseminate ARCF so long
  118.         as:
  119.  
  120.            (1)  No remuneration of any kind is received in exchange; and
  121.  
  122.            (2)  Distribution is without ANY modification to the contents of
  123.                 ARCF.COM and all accompanying documentation and/or support
  124.                 files, including the copyright notice and this license.
  125.  
  126.         No copy of ARCF may be distributed without including a copy of this
  127.         license.
  128.  
  129.         Any other use is prohibited without express, written permission in
  130.         advance.
  131.  
  132.  
  133.  
  134.                         Vernon D. Buerg
  135.                         456 Lakeshire Drive
  136.                         Daly City, CA  94015
  137.  
  138.                         CompuServe: 70007,1212
  139.                         Data/BBS:   415-994-2944
  140.  
  141.  
  142.  
  143.